home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / prohp1.zip / READ.ME < prev    next >
Text File  |  1992-11-13  |  19KB  |  549 lines
  1. Dear Clipper programmer,
  2.  
  3.              Thank you for using the ProHP demo.
  4.  
  5. +*******************************************************************+
  6. |           ProHP is the Best and Most Powerful                     |
  7. |            Laser Printer Library for Clipper                      |
  8. +*******************************************************************+
  9.  
  10.          TAKE TOTAL CONTROL OF YOUR LASER PRINTER.
  11.  
  12. ProHP's flexibility and ease of use gives you accurate and
  13. professional results every time. You don't need to learn how
  14. laser printer works
  15.  
  16. *** No Compiling needed to run this demo ***
  17.  
  18. Execute DEMO.BAT and the ProHP demo will print sample program
  19. pages, a function summary and a sample program listing. After
  20. printing, take a look at the program code to see how ProHP works.
  21.  
  22. This demo contains several programs that you can not compile
  23. without the library, however we included the output in files with
  24. the same name but with extention '.HPC' .
  25.  
  26. The ProHP library allows you to store the function results as a
  27. string variable which you can save to a file for later use.
  28.  
  29. Over 80 ProHP functions and descriptions, and over 30 sample
  30. programs come with the library, browse thru that list and see how
  31. your work-load can be reduced.
  32.  
  33. We hope you enjoy this demo. It's only the "Tip Of The Iceberg"!
  34.  
  35.  
  36. ProHP tm developed by I.L.A., Inc., Florida.
  37. (c) Copyright 1992 I.L.A., Inc. All rights reserved.
  38.  
  39.  
  40.        +===============================================+
  41.        |                  No-Risk                      |
  42.        |         30 Day Money Back Guarantee           |
  43.        |    Free upgrades during the first 90 days     |
  44.        +===============================================+
  45.  
  46. Pricing:
  47.  
  48. ProHP - Library         US$ 149.-
  49.  
  50. Add shipping charges
  51.         Europe          US$  25.-       (Air Mail, Prepaid)
  52.         USA,Canada      US$   8.50      (UPS Ground)
  53.         COD (US only add $4.-)
  54.  
  55. Other countries please call.
  56.  
  57. We accept VISA, MasterCard and Checks drawn on US banks.
  58.  
  59.  For More Information and to ORDER call 1-800-374-7734 (U.S.A. Only)
  60.                                             9am-5pm EST
  61.  
  62.        International Call +1 (407) 774-7734, Fax : +1 (407) 774-6750
  63.      or
  64.        Send a message via Compuserve to Zion Nefesh 70712,3072
  65.  
  66.                 +*********************************************+
  67.  
  68.                         Development and support
  69.  
  70.                         I.L.A., Inc.
  71.                         520 W. Hwy 436 #1180
  72.                         Altamonte Springs, FL 32714
  73.  
  74.                         Tel. (407) 774-7734
  75.                         Fax. (407) 774-6750
  76.  
  77.                         CIS: Zion Nefesh  70712,3072
  78.  
  79.                 +*********************************************+
  80.  
  81.  
  82. ProHP - Function Summary
  83. -------------------------
  84.  
  85. HP_aatsay( nTop, nLeft, aCstr [,nInc [,cJust]])
  86.  Prints an array of text, left, center or right justify, starting
  87.  at any location on the page, using any font.
  88.  
  89. HP_atsay( [nTop] , [nLeft],cStr[,lRel])
  90.  Prints text anywhere on the page. Specify absolute or relative
  91.  coordinates. You can specify measurements use row/col, inches or
  92.  centimeters after setting HPsizes().
  93.  
  94. HP_bar( nHeight, nWidth [,nFill [,nGrayPat]] )
  95.  Draw bars at the current cursor position. By changing the size
  96.  of nHeight and nWidth you can draw Horizontal bars, vertical
  97.  bars and rectangles (up to full page size).HP_bar() Uses gray
  98.  shades and patterns
  99.  
  100. HP_box( nTop, nLeft, nHeight, nWidth [,nLineWidth [,nFill at]]])
  101.  Draw boxes with control on line width, line type and shadow.
  102.  
  103. HP_center(nTop, nLeft, cStr [,nWidth])
  104.  Center a text over a column/point or in width.
  105.  
  106. HP_callmac(nMid)
  107.  Call a previously defined macro.
  108.  
  109. HP_clrmrg()
  110.  Clear the printer horizontal margins.
  111.  
  112. HP_cols( nCols )
  113.  Sets the number of columns per inch.
  114.  
  115. HP_copies(nCopies)
  116.  Use this command before the print job. You can change the number
  117.  of copies any time you desire. The last setting of nCopies is in
  118.  effect until the next printer reset.
  119.  
  120. HP_data(nIndex, Value)
  121.  HP_data() is used by ProHP for exchange of data between the
  122.  functions.
  123.  
  124. HP_diagtext(nTop,nLeft ,cStr [,nIncTop [,nIncLeft [,lRel] ] ] )
  125.  Print text diagonally, in any angle.
  126.  
  127. HP_endmacro( [nMacroId], [nStat] )
  128.  Close a macro definition.
  129.  
  130. HP_envelope( nEnvType )
  131.  Set the printer for envelope printing.
  132.  
  133. HP_execmacro( nMid )
  134.  Execute a macro.
  135.  
  136. HP_feed( [nFeed] )
  137.  Select source of input, paper or envelope. Upper/Lower Tray,
  138.  manual or envelope feeder.
  139.  
  140. HP_fillbox( nTop, nLeft, nHeight, nWidth [,nLineWidth [,nFillBox
  141.         [,nGrayPat]]] )
  142.  This allows you to draw different types of filled boxes and
  143.  control line width, fill type and shadow.
  144.  
  145. HP_font( cFont [,nAction [,nFontID ] ] )
  146.  ProHP is smart. ProHP learns the soft font loaded and adjusts
  147.  its environment to fit the use of this font.
  148.  
  149. HP_fontctrl( [nFontID] , nCtrl )
  150.  This helps you control the font downloaded to the printer. If
  151.  your printer memory has limited space and you need to optimize
  152.  the use of fonts, this helps you remove specific fonts and allow
  153.  space for new ones.
  154.  
  155. HP_hline( nTop, nLeft, nLength [,nLineWidth [,nFill [,nGrayPat]]] )
  156.  Draw a horizontal line.
  157.  
  158. HP_hmi( nHmi )
  159.  Fixed spacing fonts are affected by HMI change. When
  160.  proportional fonts are used, only the space character is
  161.  affected. The default HMI is set to the pitch value in the font
  162.  header.
  163.  
  164. HP_init()
  165.  HP_init() resets HP_data() array to its default. 
  166.  
  167. HP_lmset( nLm )
  168.  Set the left margin
  169.  
  170. HP_lmiset( nLmi )
  171.  Set the left margin in inches.
  172.  
  173. HP_lmcmset( nLmCm )
  174.  Set the left margin in centimeters.
  175.  
  176. HP_lpi( nLpi )
  177.  Set number of Lines Per Inch. This function sets the internal
  178.  VMI setting.
  179.  
  180. HP_macrocmd( nMacroCmd , nMacroId )
  181.  This macro control function lets you define, invoke and delete
  182.  macros.
  183.  
  184. HP_mkshadow( nTop,nLeft,nHeight,nWidth [,nShwdth [,nShfill
  185.         [,nShGrayPat [,nShtype]]]])
  186.  Draws a shadow around an imaginary box, ignoring the status of
  187.  HPshadow().
  188.  
  189. HP_moverlay( lSw , nMacroId )
  190.  Enable or Disable automatic overlay action to a macro.
  191.  
  192. HP_orient( nOrient )
  193.  Sets the print direction with respect to the physical page. You
  194.  can use this command only once per page. This command sets the
  195.  defaults of page length, text length, margins, VMI, HMI.
  196.  
  197. HP_pagesize( nPageSize )
  198.  Select the page size used for printing. (Letter, legal,
  199.  executive, A4)
  200.  
  201. HP_pitch( nPitch, nStyle, cSymbol )
  202.  This function helps you manipulate the Courier font in the
  203.  printer, selecting the pitch, style and symbol set.
  204.  
  205. HP_prdirect( nDir )
  206.  Sets the direction of printing. (works with HP III, PCL 5) this
  207.  command will not print the page out like when changing
  208.  orientation.
  209.  
  210. HP_rbox( nHeight, nWidth [,nLineWidth [,nFill [,nGrayPat]]])
  211.  Draw a box at the current cursor position.
  212.  
  213. HP_rcpos( nTop ,nLeft ,lRel )
  214.  Set row and column coordinates regardless of HPsizes() status.
  215.  
  216. HP_rcsay( nRow ,nCol, cStr ,lRel )
  217.  This function allows you print at any Row/Column coordinates on
  218.  the page ignoring the state of HPsizes().
  219.  
  220. HP_reset()
  221.  Send a reset command to the printer.
  222.  
  223. HP_rjust()
  224.  Right justify a text.
  225.  
  226. HP_rline( nHeight, nWidth [,nFill [,nGrayPat]] )
  227.  Draw lines at the current cursor position. By changing the size
  228.  of nHeight and nWidth you can draw Horizontal lines, vertical
  229.  lines and rectangles (up to full page size).
  230.  
  231. HP_rmset( nRm )
  232.  Set the right margin.
  233.  
  234. HP_rmiset( nRmi )
  235.  Set the right margin in inches.
  236.  
  237. HP_rmcmset( nRmCm )
  238.  Set the right margin in centimeters.
  239.  
  240. HP_savecsr(),HP_restcsr()
  241.  Push/Pop the current cursor position to/from stack.
  242.  
  243. HP_scalef( nPoint[,nStyle[,nWgt[,cSymbol[,nTypeFace]]]])
  244.  Use scalable fonts.
  245.  
  246. HP_send( lSend )
  247.  HP_send() causes ProHP to switch from sending printer code to
  248.  the output device or returning them as HPC (string variable).
  249.  
  250. HP_setpos( [ nTop ], [ nLeft ], [ lRel ] )
  251.  Control the cursor position, absolute and relative positioning. 
  252.  
  253. HP_stmacro( nMacroId )
  254.  Call this function as the first step in creating a macro. 
  255.  
  256. HP_sub( cStr )
  257.  Prints text in subscript mode.
  258.  
  259. HP_super( cStr )
  260.  Prints text in superscript.
  261.  
  262. HP_symbol( cSymbol )
  263.  Set a symbol set as the default set.
  264.  
  265. HP_textleng( nTextLength )
  266.  Set the number of lines per page before auto eject.
  267.  
  268. HP_tmset( nTopMargin )
  269.  This command designates the number of lines between the top of
  270.  the page to the top of the text area.
  271.  
  272. HP_tmiset( nTMi )
  273.  Set top margin in inches.
  274.  
  275. HP_tmcmset( nTMi )
  276.  Set top margin in centimeters.
  277.  
  278. HP_ulset( lUnderline )
  279.  Set underline mode ON or OFF.
  280.  
  281. HPulstr( cStr )
  282.  Underline text.
  283.  
  284. HP_usefont( nFontId )
  285.  Select the font previously downloaded to the printer with
  286.  nFontID.
  287.  
  288. HP_vline( nTop, nLeft, nLength [,nLineWidth [,nFill 
  289.  Draw vertical line.
  290.  
  291. HP_vmi( nVmi )
  292.  Set Vertical Motion Index to nVmi, This command affects the line
  293.  feed, and HP_data(D_LPI) is updated to reflect the new LPI.
  294.  
  295. HP_vprint( nTop, nLeft, cStr , nInc)
  296.  This function takes cStr and prints it vertically starting at
  297.  nTop,nLeft stepping down with nInc.
  298.  
  299. HP_wrap( lWrap )
  300.  When end of line wrap is enabled, any text beyond the right
  301.  margin will be printed on the next line. If disabled, the text
  302.  after the right margin is clipped.
  303.  
  304. HPbold(nStr)
  305.  Make a boldface string. This function will work with any font.
  306.  
  307. HPccm2i( nCm )
  308.  Convert cm to inch. If HPsizes() is set to inches then nCm
  309.  converts to inches.
  310.  
  311. HPci2cm( nInch )
  312.  Convert inch size to centimeter if current size used is in
  313.  centimeters.
  314.  
  315. HPcm2col( nCm )
  316.  Convert CM to columns.
  317.  
  318. HPcm2row( nCm )
  319.  Convert CM to rows.
  320.  
  321. HPcol2cm( nCol )
  322.  Convert column coordinate to centimeters.
  323.  
  324. HPcol2i( nCol )
  325.  Get the size of nColumns in inches. This function can also give
  326.  you the length of any fixed space font if HP_cols(font pitch) is
  327.  set.
  328.  
  329. HPdownload(cFontName [,cLpt [,nFontID [,nSetFont]]])
  330.  HPdownload is used for downloading any file in binary mode to
  331.  the printer. You can quickly send previously built forms and
  332.  letters or any printable file. To send, use HPdownload( cFname ,
  333.  cLpt ) where cFname is the file you want to send to the printer,
  334.  and cLpt is the output device.
  335.  
  336. HPdrawmonth( dDate, nTop, nLeft, nHeight, nWidth )
  337.  Draws a monthly calendar. The function return an array with the
  338.  coordinates of each day box. Size of calendar from 1" x 1" to a
  339.  full page.
  340.  
  341. HPfonthead( cFontName )
  342.  This font helps you explore the structure of any soft font.
  343.  
  344. HPgraytext( nStr [,nFill [,nGrayPat [,nHeight]] )
  345.  Print text on gray or pattern background.
  346.  
  347. HPhfont()
  348.  HPhfont is used to determine the cell height of the font. This
  349.  function updates each call to HP_pitch() and call to HP_font().
  350.  Use this function when you design fine graphics and need to know
  351.  the exact height of the font. You can get this information by
  352.  reading the font description data array with HPfonthead().
  353.  
  354. HPi2col( nInch )
  355.  Determine the number of columns in nInch.
  356.  
  357. HPreplicate( cStr , nWidth )
  358.  Used to repeatedly print one or more characters in nWidth.
  359.  
  360. HPsavecsr(), HPrestcsr()
  361.  Use this command when you want to save and restore the cursor
  362.  location. This function returns HPC regardless of HP_send()
  363.  status.
  364.  
  365. HProw2cm( nRow )
  366.  Convert rows to centimeters.
  367.  
  368. HProw2i( nRow )
  369.  Convert rows to inches.  Useful when mixing row/col coordinates
  370.  and inches.
  371.  
  372. HPscale( nScale )
  373.  This Unique function lets you specify the scale factor for the
  374.  height and width size in the next drawings. You can match your
  375.  output to a different size area without having to recalculate
  376.  the new sizes.
  377.  
  378. HPsetshadow( nShWdth, nShFill ,nShGrayPat ,nShType )
  379.  Alternative way to set new defaults for box shadow.
  380.  
  381. HPshadow( lShadow )
  382.  ProHP will do all the calculations to draw a shadow with the
  383.  width, filltype ,gray/pattern and position. All you need is to
  384.  set HPshadow(.t.).
  385.  
  386. HPsizes( nMeasure )
  387.  Set unit of measure for ProHP functions. Not all functions
  388.  accept measures in cm or row/col.
  389.  
  390. HPstsize( cStr )
  391.  Position text anywhere you like. It is easy to justify (center
  392.  or right) when you know the text length, especially with
  393.  proportional fonts. This function works with all fixed space
  394.  fonts (even if you change HMI) and with all soft font downloaded
  395.  using HP_font(). Scalable fonts supported with this function are
  396.  CGTIMES and UNIVERSE (resident in HP III)
  397.  
  398. HPwchars( cFont )
  399.  ProHP reads the font file with all the necessary data for the
  400.  different functions needed to handle it. ProHP reads the chars
  401.  width during the process of downloading the font to the printer
  402.  when using HP_font().
  403.  
  404. Set2Print( cDevName )
  405.  Set the output device to cDevName. Use this function before
  406.  printing.
  407.  
  408. Set2Screen()
  409.  Set the output device to the screen, closing the device opened
  410.  previously with set2print(cDevName)
  411.  
  412. zAddMonth(dDate, nMonths)
  413.  Add/ deduct month(s) from a date.
  414.  
  415. zMdy2Date(nMonth, nDay, nYear)
  416.  make a date from 3 integer vars (nMonth,nDay,nYear).
  417.  
  418.  
  419.  
  420. ProHP - Sample Programs
  421. -------------------------
  422.  
  423. ATSAY.PRG    Shows you the use of HP_atsay() by printing a report
  424.              inside gray shaded box with drop down shadow.
  425.  
  426. BAR.PRG      Another way to see and use relative movement
  427.              functions.
  428.  
  429. CALENDAR.PRG You are going to love this one. Compile and run it
  430.              NOW!.
  431.  
  432. COLS.PRG     HP_cols() is very useful and powerful function. This
  433.              will draw a  15 cm ruler, and mark each millimeter.
  434.  
  435. DIAGTEXT.PRG Demonstrates how to print text diagonally.
  436.  
  437. ENVELOPE.PRG Probably the easiest way to print envelopes. This
  438.              program shows you how to print envelopes by reading
  439.              addresses from a file.
  440.  
  441. FONTS.PRG    This program shows you how to manipulate fonts with
  442.              ProHP functions and select a font using an alias.
  443.              You may modify this program and adopt the technique
  444.              shown to set complicated printer environment
  445.              settings.
  446.  
  447. FILLBOX.PRG  24 different boxes are filled with gray shade
  448.              patterns and shadow printed using this program.
  449.  
  450. FONTHEAD.PRG Read any given soft font file and display the font
  451.              descriptor data.
  452.  
  453. GRAPH.PRG    Demonstrate how to easily generate bar graphs. Two
  454.              methods are demonstrated here, and you can adopt it
  455.              to your needs immediately.
  456.  
  457. GRAYTEXT.PRG Demonstrates the use of HPgraytext() by printing
  458.              text with different backgrounds (gray shade or
  459.              pattern). This also shows the use of HP_font() and
  460.              how to load and use soft fonts.
  461.  
  462. HMI.PRG      Demonstrate the use of HP_hmi() by showing a way to
  463.              force a 10 pitch font to be printed as 12 pitch and
  464.              16.66 pitch forced to 20 pitch. Expand any pitch
  465.              used with any fixed spacing font to any other pitch.
  466.              We drew an Inch ruler at the background of the text
  467.              to show the behavior of the text when using
  468.              HP_hmi().
  469.  
  470. HPSCALE.PRG  Unique to ProHP . Change your drawing size with one
  471.              call to HPscale().
  472.  
  473. HPSHADOW.PRG Short program to show the use of shadow boxes.
  474.  
  475. LPI.PRG      ProHP allows you to specify any Lines Per Inch
  476.              count. LPI.PRG shows you 4 ways to control and use
  477.              HP_lpi(). Find how many lines can be used in a box
  478.              or any Height, Set the number of lines in any Height
  479.              to fit x number of lines in that height. The use of
  480.              HProw2i() and HPcol2i() is demonstrated.
  481.  
  482. MARGINS.PRG  This program demonstrates the use of margin setting
  483.              by showing you how to set margins (by sizes columns,
  484.              inch or centimeter) accurately to a of a tenth of a
  485.              millimeter.
  486.  
  487. ORIENT.PRG   HP_orient is a simple function to change the page
  488.              orientation. This program shows you how to store
  489.              ProHP commands in an array of a string variable for
  490.              conditional operation.
  491.  
  492. PAGESIZE.PRG Control page size. Change page size from letter to
  493.              legal and print text on the entire page. Print 130
  494.              lines of text on a legal size paper.
  495.  
  496. PRINV.PRG    Easy form building! Create an invoice form and fill
  497.              it with the invoice data. See how to resize the form
  498.              by ONE (1) command, HPscale().  ProHP  saves the
  499.              invoice format to a file so you can retrieve it
  500.              later. Stay on this program, there are many good
  501.              ideas to learn here.
  502.  
  503. PUBLISH.PRG  Many functions are used in this program to draw a
  504.              page of text in columns using different font sizes,
  505.              a monthly calendar and graph is inserted in the text
  506.              column. There is a lot to learn from this program.
  507.              If you understand how this program does all this
  508.              then there is no limit to what you can do with ProHP
  509.              and your printer.
  510.  
  511. RELATIVE.PRG Beautiful program to demonstrate a ProHP function
  512.              that uses relative movement and cursor location line
  513.              draw. Compile and run it- you'll be impressed.
  514.  
  515. ROW2CM.PRG   Short program on HProw2cm() and other conversion
  516.              functions.
  517.  
  518. ROW2I.PRG    Convert row to inchs.
  519.  
  520. SCALEF.PRG   Using scalable fonts is easy with ProHP. This
  521.              program shows you how to select and use a scalable
  522.              font.
  523.  
  524. SEND.PRG     HP_send() will make your laser printer programming very
  525.              easy. This short program will show you how to use it.
  526.  
  527. SHADOW.PRG   This program will show you many different shadow boxes
  528.              using grays and pattern shadow.
  529.  
  530. SHADOWT.PRG  Draw 9 different boxes showing all shadow types. It also
  531.              shows how to center an array of text inside a box using
  532.              code block.
  533.  
  534. STRSIZE.PRG  Get string size and center it in any width and over a
  535.              column.
  536.  
  537. SUB_SUP.PRG  Text printed in subscript and superscript mode is used in
  538.              this program.
  539.  
  540. SYMBOL.PRG   Small program to show the use of HP_symbol()
  541.  
  542. TEXTLENG.PRG One way of using HP_textleng(). Macros use is also
  543.              shown here.
  544.  
  545. UNDERLN.PRG  A very Unique way to underline text.
  546.  
  547. VPRINT.PRG   Print a text vertically , move relative and center text.
  548. E
  549.